home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / rpccmd.man < prev    next >
Encoding:
Text File  |  1992-08-13  |  5.3 KB  |  201 lines
  1.  
  2.  
  3.  
  4. RPCCMD                    User Commands                    RPCCMD
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      rpccmd - Control the RPC system
  12.  
  13. SSYYNNOOPPSSIISS
  14.      rrppccccmmdd  [_o_p_t_i_o_n_s]
  15.  
  16. OOPPTTIIOONNSS
  17.      --oonn           Turn on the server half of the RPC system.
  18.  
  19.      --ooffff          Turn off the server half of the RPC system.
  20.  
  21.      --ppiinngg _h_o_s_t    Do an RPC test against the specified host.
  22.  
  23.      --bb _s_i_z_e       The amount of data to send in each RPC test.
  24.  
  25.      --tt [00||11]      Set the value  of  the  rpc_Tracing  variable.
  26.                    RPC  tracing  facilitates  debugging, but adds
  27.                    overhead to each RPC.
  28.  
  29.      --DD [00||11]      Set the value of the  rpc_Debug  variable.   A
  30.                    non-zero value causes each RPC to be logged to
  31.                    /dev/syslog.  This really slows things down!
  32.  
  33.      --TT [00||11]      Set the value of the rpc_NoTimeouts  variable.
  34.                    A  non-zero  value makes all RPCs try forever.
  35.                    This is dangerous because a  server  call-back
  36.                    to a dead client will hang the server.
  37.  
  38.      --CC [00||11]      Turn off/on timings of RPC on the client side.
  39.                    Use  rrppccssttaatt  to  dump  out  the histograms of
  40.                    times that are taken by the kernel.
  41.  
  42.      --SS [00||11]      Turn off/on timing of the RPC service times as
  43.                    measured by the server.
  44.  
  45.      --CCrreesseett       Reset the client-side timing histograms.
  46.  
  47.      --SSrreesseett       Reset the server-side timing histograms.
  48.  
  49.      --mmaaxxSSeerrvveerrss _n_u_m_b_e_r
  50.                    Set the maximum number of allowed  rpc  server
  51.                    processes.
  52.  
  53.      --nnuummSSeerrvveerrss _n_u_m_b_e_r
  54.                    Create more  rpc  servers  until  this  number
  55.                    exists.
  56.  
  57.      --nneeggAAcckkssOOnn    Allow the machine to  generate  negative  ack-
  58.                    nowledgements.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v.1.0        Printed:  August 13, 1992                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RPCCMD                    User Commands                    RPCCMD
  71.  
  72.  
  73.  
  74.      --nneeggAAcckkssOOffff   Prevent the machine from  generating  negative
  75.                    acknowledgements.
  76.  
  77.      --cchhaannnneellNNeeggAAcckkssOOnn
  78.                    Turn on the client policy of ramping down  the
  79.                    number  of channels it uses with a server that
  80.                    has  returned   a   negative   acknowledgement
  81.                    recently.
  82.  
  83.      --cchhaannnneellNNeeggAAcckkssOOffff
  84.                    Turn off the client policy of ramping down the
  85.                    number  of channels it uses with a server that
  86.                    has  returned   a   negative   acknowledgement
  87.                    recently.  Use back-off instead.
  88.  
  89.      --nnuummPPiinnggss     Number of pings to send to the specified  host
  90.                    (defaults to 100).
  91.  
  92.      --ssaanniittyy [00||11] Turn off/on sanity checking  of  RPC  packets.
  93.                    The  types  of sanity checks done are intended
  94.                    for debugging purposes and probably  shouldn't
  95.                    be used during normal operation.
  96.  
  97. _________________________________________________________________
  98.  
  99. IINNTTRROODDUUCCTTIIOONN
  100.      This command is used to set various  control  parameters  of
  101.      the RPC system.  The most important is the --oonn option, which
  102.      is used during the boot sequence to enable RPC service after
  103.      local  initialization (i.e. disk checks) is done.  The --ppiinngg
  104.      option is used to ping another sprite host.  This is  useful
  105.      to  find  out  if the host is up, and the make sure that the
  106.      host knows you are alive.  This does an  RPC_SEND,  and  the
  107.      amount of data sent can be specified with the --bb option.
  108.  
  109.      Each of the --tt, --DD, --TT, --CC, and --SS options set the value  of
  110.      a  kernel  variable.  --tt is used to turn on or off the trace
  111.      of the last 100 RPC packets.  --DD is used to turn on  or  off
  112.      debugging  print  statements.   --TT is used to turn on or off
  113.      "no timeout mode".  This mode is  useful  when  debugging  a
  114.      client  and  you  don't want the server to timeout and think
  115.      the client has crashed.  It is dangerous,  however,  because
  116.      if the server ever makes a call-back to a truely dead client
  117.      it will hang until the no timeout mode is turned off.
  118.  
  119.      The --CC and --SS options turn on or off timings  of  individual
  120.      RPCs.   --CC  controls  timing on the client side, and --SS con-
  121.      trols timing on the server side.  The timings  are  kept  in
  122.      histogram form.  Use the --CCrreesseett and --SSrreesseett options to zero
  123.      out the histograms.  Use rrppccssttaatt to display them.
  124.  
  125. SSEEEE AALLSSOO
  126.      rpcstat
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0        Printed:  August 13, 1992                   2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. RPCCMD                    User Commands                    RPCCMD
  139.  
  140.  
  141.  
  142. KKEEYYWWOORRDDSS
  143.      rpc, trace, debug
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0        Printed:  August 13, 1992                   3
  198.  
  199.  
  200.  
  201.